home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / DJGPP / CBGRX103.ZIP / contrib / libgrx / docs / tests.doc < prev   
Text File  |  1993-12-06  |  2KB  |  77 lines
  1. Introduction
  2. ============
  3.  
  4. This document gives a brief description of the test programs in the
  5. 'tests' sub-directory.
  6.  
  7. The test programs were not intended as a flashy demo of the capabilities
  8. of LIBGRX. Their purpose is to test the various services of the library.
  9. The general syntax of their usage is:
  10.  
  11.     go32 <prog> [<width> <height> [<color>]] <additional arguments>
  12.             -- or for the Turbo C tests --
  13.     <prog> [<width> <height> [<color>]] <additional arguments>
  14.  
  15. The test programs typically display several screens, hitting any key
  16. will advance to the next screen. In a few cases the keyboard is used
  17. differently, these programs will be described below.
  18.  
  19.  
  20. Description of the test programs:
  21. =================================
  22.  
  23.     TEST:
  24.     perform video adapter speed test and test the basic primitives
  25.     of the library.
  26.  
  27.     WINTEST, WINCLIP, CLIPTEST:
  28.     test graphics contexts sub-contexts and clipping
  29.  
  30.     FRAMTEST:
  31.     demo of the framed box primitive
  32.  
  33.     BLITTEST:
  34.     test the bit block transfer function. First it tests the bitblt
  35.     primitive for 64 possible alignment cases in planar modes (8
  36.     possible alignments for the source and destination each). It does
  37.     this test both for forward and backward copy (it depends on
  38.     whether the source address is bigger than the destination) and
  39.     for a system RAM graphics context source. A wide and a narrow
  40.     test pattern is used. After finishing the basic tests the program
  41.     gives a demo of tiling the screen with a pattern similar to the
  42.     one in FRAMTEST.
  43.  
  44.     RGBTEST:
  45.     tests the 256 color RGB mode.
  46.  
  47.     COLOROPS:
  48.     tests the four write modes: SET, XOR, OR, AND
  49.  
  50.     CURSTEST:
  51.     tests the graphics cursor drawing routines, Keyboard usage:
  52.        u U        (up)        \
  53.        d D        (down)          move the cursor
  54.        l L        (left)          capitals faster
  55.        r R        (right)        /
  56.        q                exit program
  57.  
  58.     MOUSETST:
  59.     test the mouse cursor and the rubberband cursor options.
  60.  
  61.     POLYTEST:
  62.     test the polygon filling algorithm. It takes the coordinates
  63.     of the polygons from the data file "polytest.dat"
  64.  
  65.     CIRCTEST:
  66.     test the circle drawing algorithm with a circle, horizontal and
  67.     vertical main axis ellipse. It draws the exact points (calculated
  68.     using FP arithmetics) in red. The 'q' key aborts the test.
  69.  
  70.     TESTPATT:
  71.     tests the pattern filled graphics primitives.
  72.  
  73.  
  74. NOTE: these programs can also be used as examples for the usage of the
  75. library. As always: CONSULT THE SOURCE!!!!
  76.  
  77.